home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / dsz0711.arc / DSZ.DOC < prev    next >
Text File  |  1988-07-11  |  43KB  |  1,519 lines
  1.  
  2.  
  3.  
  4.           DSZ - a ZMODEM, True YMODEM(TM), XMODEM File Transfer Program
  5.  
  6.                                   Chuck Forsberg
  7.  
  8.                                Omen Technology Inc
  9.  
  10.  
  11.                            Omen Technology Incorporated
  12.                           The High Reliability Software
  13.  
  14.                        17505-V Northwest Sauvie Island Road
  15.                               Portland Oregon 97231
  16.               Modem: 503-621-3746 Speed 1200,2400,19200(Telebit PEP)
  17.                          Compuserve:70007,2304  GEnie:CAF
  18.                         UUCP: ...!tektronix!reed!omen!caf
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.     Chapter 0              Rev 6-30-88  Typeset 7-11-88                      1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.     Chapter 0                  DSZ Quick Reference                           2
  71.  
  72.  
  73.  
  74.     1.  FAIR PLAY
  75.  
  76.     Unlike snazzy menu interfaces, reliable high speed transfer protocols take
  77.     many hours of testing, often over expensive phone connections, to develop.
  78.     Two decades of communications experience and protocol testing are
  79.     distilled in DSZ.
  80.  
  81.     DSZ is a user supported program developed and supported by Chuck Forsberg,
  82.     owner of Omen Technology.  Countless hours of work and expen$ive resources
  83.     went to develop and support DSZ for the myriad environments users use it
  84.     in.  The fact that most of the problems people encounter with DSZ are
  85.     caused by other software, hardware problems, failure to read the supplied
  86.     documentation, or pirating has not kept users from seeking and getting
  87.     help, even if it means calling the author in the middle of his sleep.
  88.  
  89.     Beyond this, the world of communications is constantly evolving, and it
  90.     requires a significant ongoing effort to keep DSZ and its documentation up
  91.     to date with the current state of the art.  Individuals with little
  92.     knowledge of the dynamic nature of telecommunications (or hidden agendas)
  93.     have misrepresented the frequency of enhancements to DSZ as a sign that
  94.     DSZ is "unstable" and unworthy of "serious consideration".  If you think
  95.     such sniping is fair play, you are more than welcome to use one of the
  96.     many other protocol programs available, each of which claim to offer speed
  97.     and reliability comparable to DSZ.
  98.  
  99.     Non registered users are welcome to use DSZ for a reasonable evaluation
  100.     period.  "Reasonable" means "until you've decided whether the program is
  101.     worth $20.00".  It does not mean "until some competing program gets around
  102.     to adding ZMODEM or True Ymodem(TM)".  Afterwards, ethical use of DSZ
  103.     requires registering the copy.
  104.  
  105.     DSZ is not and never has been Public Domain.  Every version of DSZ has
  106.     included a Copyright Notice and a prohibition against sale or
  107.     modification.  There is no usage counter or other Trojan Horse in DSZ, but
  108.     if you use this program, you have a moral and ethical obligation to
  109.     register it.
  110.  
  111.     Registration enables OverThruster(TM), YMODEM-g, and other advanced
  112.     features.  The registration package serializes all past and future
  113.     versions of DSZ.COM and DSZ.EXE.
  114.  
  115.     1.1  Sharing DSZ Files
  116.  
  117.     You are welcome to share unmodified copies of DSZ.ARC with your friends
  118.     and associates for their evaluation.  This documentation file and the
  119.     MAILER file must be provided with all copies of DSZ except by prior
  120.     written permission from Omen Technology Inc.  Because of piracy problems,
  121.     Omen Technology must INSIST that DSZ be distributed only as part of the
  122.     DSZ.ARC file EXACTLY as provided by Omen Technology Inc or Dynamis
  123.     Software.
  124.  
  125.  
  126.  
  127.  
  128.     Chapter 1              Rev 6-30-88  Typeset 7-11-88                      2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     Chapter 1                  DSZ Quick Reference                           3
  137.  
  138.  
  139.  
  140.     PLEASE!!! Do NOT repack the Omen supplied DSZ.ARC file with Pkarc!!!
  141.  
  142.     The few bytes saved by PKARC are more than offset by confusion and
  143.     increased difficulty identifying virus infection and unauthorized patches.
  144.  
  145.     The only approved exceptions to this rule are:
  146.  
  147.      [1]  Dissemination the contents of the DSZ.DOC file (part of DSZ.ARC) in
  148.           a convenient machine readable or human readable form, providing the
  149.           editorial content is unchanged.
  150.  
  151.      [2]  Encoding the DSZ.ARC file into printable characters for transmission
  152.           over text based networks and/or message/news distribution systems.
  153.           The "uuencode" program used with Usenet comp.binaries is an instance
  154.           of such encoding.
  155.  
  156.     If you distribute DSZEXE.ZOO, DSZ.ARC must be included in the same
  157.     directory since DSZEXE.ZOO references files in DSZ.ARC.  The DSZEXE.ZOO
  158.     file may not be modified in any way, including repacking with another
  159.     archive program.  I ask this favor because Rahul's ZOO is a superior
  160.     archiving format, and I want to help it along.
  161.  
  162.     If you see an unpacked, repacked, or otherwise modified DSZ archive or
  163.     parts thereof in a bulletin board, please ask the board's operator to
  164.     replace such files with DSZ.ARC exactly as provided by Omen Technology
  165.     Inc.  Flame them until they behave responsibly.
  166.  
  167.     No version of DSZ may be sold without the prior written permission of Omen
  168.     Technology Inc.
  169.  
  170.     Distribution of programs that modify, patch, disassemble, decompile, or
  171.     otherwise reverse engineer DSZ without prior written permission by Omen
  172.     Technology Inc is a bloody theft of services and a violation of federal
  173.     copyright law.  The same applies to debug scripts and documentation
  174.     written for the same purposes.  When possible, such piracy will be
  175.     referred to the FBI for investigation and prosecution under federal
  176.     conspiracy statutes.  Applicable "RICO" law provides for treble damages
  177.     and recovery of attorney's fees.  So far, none of the cretins producing
  178.     such bilge have seen fit to sign their real name and address to their
  179.     attempts at ego gratification.
  180.  
  181.     Distribution of DSZ in any medium without this documentation file is an
  182.     unauthorized modification to DSZ that deprives the rightful author of
  183.     registration revenues.  That is a theft of intellectual property.  Such
  184.     distribution also damages the author also obliges the user and author to
  185.     waste time and phone bills scrounging for the documentation, and answering
  186.     questions that are fully covered in the documentation.
  187.  
  188.     If any version of DSZ is distributed with any other product, software or
  189.     hardware, the product documentation must clearly and prominently state
  190.     that the customer's continued use of DSZ requires registration directly
  191.  
  192.  
  193.  
  194.     Chapter 1              Rev 6-30-88  Typeset 7-11-88                      3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     Chapter 1                  DSZ Quick Reference                           4
  203.  
  204.  
  205.  
  206.     with Omen Technology or its duly authorized agent(s).  When DSZ is
  207.     distributed on disk, a contemporary copy of ZCOMMDOC.ARC should be
  208.     included on the same disk.
  209.  
  210.     Thank you for your support.
  211.  
  212.     1.2  REGISTRATION
  213.  
  214.     After a short evaluation period, users should register their copy of DSZ
  215.     with a check for $20.00 in U.S. funds sent to:
  216.  
  217.            Omen Technology Inc.
  218.            P.O. Box 4681
  219.            Portland, OR 97208
  220.            For VISA/MC Registrations, call 503-621-3406
  221.  
  222.     Canadians should remit to:
  223.  
  224.            Dynamis Productivity Software LTD
  225.            P. O. Box 5008, Station B
  226.            Victoria BC V8R 6N3
  227.  
  228.     The address on your check is sufficient, no need to fill out forms.
  229.  
  230.     Don't bother scrounging for an envelope, just print the INSTANT MAILER
  231.     included in this archive!
  232.  
  233.     Users, especially those overseas, may choose to register their copy of DSZ
  234.     for $25.00 U.S.  by providing their VISA or Mastercard card number with
  235.     expiration date and their name as it appears on their credit card.
  236.     Overseas registrations are sent out Air Mail.
  237.  
  238.     *************************************************************************
  239.     The user registration package includes a printed serial number card,
  240.     latest versions of the DSZ programs, the installation program which
  241.     enables features and bypasses the opening advertisement, and additional
  242.     documentation.
  243.  
  244.     The registration package serializes all past and future versions of
  245.     DSZ.COM and DSZ.EXE.
  246.     *************************************************************************
  247.  
  248.     The unique serial number on the registration card is registered to the
  249.     user, and is acceptable proof of registration to corporate auditors.
  250.  
  251.     The putsnp program inserts your unique DSZ Serial Number Password (SNP)
  252.     into you copy of DSZ with the following command:
  253.            putsnp dsz.com
  254.     Putsnp accepts your SNP and asks appropriate questions before inserting
  255.     the SNP.
  256.  
  257.  
  258.  
  259.  
  260.     Chapter 1              Rev 6-30-88  Typeset 7-11-88                      4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     Chapter 1                  DSZ Quick Reference                           5
  269.  
  270.  
  271.  
  272.     Some TSR programs have been known to interfere with putsnp.  If you have a
  273.     lockup running putsnp, run it without any TSR programs.
  274.  
  275.  
  276.     The only legitimate way to disable the opening advertisement in DSZ is to
  277.     insert an authorized SNP obtained from Omen Technology into DSZ with the
  278.     putsnp program.  Any other suppression or modification of the opening
  279.     screen is an illegal, unethical theft of services.
  280.  
  281.     Piracy is stealing.
  282.  
  283.  
  284.     1.3  Files on Registration Disk
  285.  
  286.     The following files are currently included on the Registration Disk sent
  287.     to paid registrants.
  288.  
  289.     DSZEXE.ZOO     Contains DSZ.EXE.
  290.  
  291.  
  292.     DSZ.ARC        Contains DSZ.COM, this document, DESQview description
  293.                    files, and an instant no-effort registration mailer.
  294.  
  295.  
  296.     YZMODEM.ZOO    Contains Official YMODEM and ZMODEM protocol descriptions.
  297.  
  298.  
  299.     LOOZ.DOC       Documentation on running the LOOZ program
  300.  
  301.  
  302.     LOOZ.EXE       Program to unpack .ZOO archives
  303.  
  304.  
  305.     RZSZ.ZOO       ZMODEM C source code, porting base for several dozen ZMODEM
  306.                    implementations
  307.  
  308.  
  309.     PUTSNP.EXE     Installs your unique registered serial number into DSZ.
  310.  
  311.  
  312.     DSZBG.DOC      Background information for DSZ, part of the ZCOMM User's
  313.                    Manual.  DSZBG.DOC is for registered users only;
  314.                    unregistered users are welcome to read the ZCOMM manual
  315.                    contained in ZCOMMDOC.ARC.
  316.  
  317.     1.4  Bulletin Board Registration
  318.  
  319.     DSZ may be freely used and copied by public bulletin board systems which
  320.     agree to the conditions stated in the accompanying bbs_reg.txt file.
  321.     Those not abiding to these conditions must obtain a paid registration for
  322.     each node.
  323.  
  324.  
  325.  
  326.     Chapter 1              Rev 6-30-88  Typeset 7-11-88                      5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.     Chapter 1                  DSZ Quick Reference                           6
  335.  
  336.  
  337.  
  338.     Free bulletin board registrations are processed in batches.
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.     Chapter 1              Rev 6-30-88  Typeset 7-11-88                      6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.     Chapter 2                  DSZ Quick Reference                           7
  401.  
  402.  
  403.  
  404.     2.  DESCRIPTION
  405.  
  406.     DSZ is a "protocol driver" that uses the ZMODEM, True YMODEM(TM), or
  407.     XMODEM protocol to transfer files over a serial port with a variety of
  408.     programs.
  409.  
  410.     ZMODEM Transfers feature 32 bit CRC, crash recovery, and advanced file
  411.     management.
  412.  
  413.     When calling bulletin boards to download files with ZMODEM you can avoid
  414.     the bother of starting DSZ for each transfer by calling DSZ first, before
  415.     asking the BBS for the download.          dsz t The "t" command allows you
  416.     to keyboard the file request to the BBS.  DSZ's ZMODEM AutoDownload then
  417.     receives the file automatically, without any wasted keystrokes or delay.
  418.     Try it, you'll like it!  (The "t" command is described below.)
  419.  
  420.     YMODEM downloads are almost as easy.  Use the "t" command as shown above,
  421.     and hit the F3 key after telling the board to download a file with YMODEM.
  422.  
  423.     ZMODEM and True YMODEM(TM) transfers preserve exact file length and
  424.     modification time.
  425.  
  426.     DSZ supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes mislabeled
  427.     YMODEM) and CRC-16 with the sx -k and rc commands.
  428.  
  429.     DSZ is derived from Omen Technology's "Professional-YAM" high reliability
  430.     communications tools, (also known as PowerCom(TM)), and supports a subset
  431.     of Pro-YAM's file transfer related commands.  This documentation makes
  432.     extensive references to contemporary editions of the ZCOMM or Pro-YAM
  433.     manual, and is incomplete without it.
  434.  
  435.     DSZ is designed to be called from a communications bulletin board program.
  436.     DSZ may also be called from other communications programs, but the
  437.     combination lacks much of the enjoyable user friendliness of a program
  438.     with integrated ZMODEM.
  439.  
  440.     DSZ uses its own modem I/O.  The original interrupt vector, UART parity,
  441.     and interrupt configuration are restored on exit.  The original state of
  442.     the 8259 interrupt mask bit for this vector is also restored on exit.
  443.  
  444.     DSZ uses DOS standard output (stdout) for messages.  It never writes
  445.     directly to the screen.  DSZ expects its standard output to point to the
  446.     console, a logging file, or NUL, not the modem port.  If dsz's standard
  447.     output is redirected to the modem (as with ProComm's Host mode DOS shell),
  448.     the combination may lock up the computer.  If necessary, dsz's standard
  449.     output may be redirected back to the console device with the CON command.
  450.  
  451.     DSZ exits with 0 status for successful transfers, or the value of the Q
  452.     parameter (default 1) if a file transfer failed.  Some languages do not
  453.     return this information to the calling program.  Some language
  454.     implementations freak out on certain non-zero exit values.  A batch file
  455.  
  456.  
  457.  
  458.     Chapter 2              Rev 6-30-88  Typeset 7-11-88                      7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.     Chapter 2                  DSZ Quick Reference                           8
  467.  
  468.  
  469.  
  470.     that calls DSZ directly may be used to detect the DSZ exit status, or
  471.     DSZ's log file entries may be examined.
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.     Chapter 2              Rev 6-30-88  Typeset 7-11-88                      8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.     Chapter 3                  DSZ Quick Reference                           9
  533.  
  534.  
  535.  
  536.     3.  COMMANDS
  537.  
  538.     dsz [CON] [port N] [speed S] [handshake XX] [D] [d] command
  539.  
  540.     DSZ commands are an improper subset of Pro-YAM/PowerCom/ZCOMM commands.
  541.     They are fully described in the ZCOMM User's Manual, contained in
  542.     ZCOMMDOC.ARC.  Portions of that document are included with the DSZ
  543.     registration disk.  Please refer to that document for details on the
  544.     following commands.
  545.  
  546.            ***********************************************************
  547.                                     NOTE WELL
  548.     Except as noted, all commands must be in entered lower case.  (Case is
  549.     significant!)
  550.            ***********************************************************
  551.  
  552.     When used (in any combination), the CON, port, speed, handshake, and d
  553.     commands must be given in the order shown.
  554.  
  555.  
  556.     CON   Redirect message output to the DOS "CON" (console) device,
  557.           overriding any previous redirections.  This is necessary to avoid
  558.           lockups caused by Procomm host mode.  Most programs do not require
  559.           this hack.  This command is unique to DSZ.
  560.  
  561.     handshake XX Enable one of several choices of hardware handshake.  (The
  562.           default is XOFF/XON software handshake).  This command is documented
  563.           in the ZCOMM or Pro-YAM manual, and in DSZBG.DOC.  (The ZCOMM manual
  564.           is available on all bulletin boards registered for DSZ as
  565.           ZCOMMDOC.ARC.) On DSZ the "handshake" command may be abbreviated to
  566.           "ha".
  567.  
  568.     port N select port N (n = 1,2,3,4,5,6,7,8, 10,11,12,13,14,15,16,17,18)
  569.           Default is port 1 (COM1) or read from the DSZPORT dos environment
  570.           variable.  COM10 to COM18 refer to the COM1 to COM8 ports on the
  571.           PS/2.
  572.  
  573.           In multitasking operation, accessing a port used by another running
  574.           program may hang the machine.
  575.           EXAMPLE: to use COM2:
  576.           dsz port 2 rz
  577.  
  578.     portx ... Select arbitrary port address and interrupt vector.  Please
  579.           refer to the ZCOMM or Professional-YAM manual for information on
  580.           this command.
  581.  
  582.     speed S Set the specified speed.  This command is rarely needed because
  583.           DSZ reads the port's current speed by default.  Please refer to the
  584.           FLOW CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters in the
  585.           ZCOMM or Pro-YAM manual for important information about the speed
  586.           command.
  587.  
  588.  
  589.  
  590.     Chapter 3              Rev 6-30-88  Typeset 7-11-88                      9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.     Chapter 3                  DSZ Quick Reference                          10
  599.  
  600.  
  601.  
  602.     D     Disables the modem (drops Data Terminal Ready, DTR) if carrier is
  603.           lost.  This may be used to prevent spurious events (phone ringing)
  604.           from interfering with the calling bulletin board's recovery from
  605.           carrier loss.
  606.  
  607.     d     Disables carrier dropout monitoring, for modems that do not properly
  608.           drive the "Data Carrier Detect" input on the PC.  If you see a
  609.           CARRIER LOST message, you need to give the d command.
  610.  
  611.     LARG  Convert ARG to lower case, then parse arg.
  612.  
  613.     pxN   Set a numeric parameter x to N.  These parameters are mostly a
  614.           subset of the Pro-YAM/ZCOMM numeric parameters, and are listed
  615.           below.  They assume their defaults each time DSZ is called.  Without
  616.           an argument, p displays the numeric parameters and their values.
  617.  
  618.           EXAMPLE: C>dsz p
  619.  
  620.           z pxN Set zmodem numeric parameter x to N.  These parameters
  621.           correspond to the Pro-YAM or ZCOMM "zmodem" parameters and rarely
  622.           need changing.  These parameters assume their defaults each time DSZ
  623.           is called.  Without an argument, z p displays the zmodem numeric
  624.           parameters and their values.
  625.  
  626.     restrict Restrict pathnames to the current disk and directory tree, and
  627.           disallow overwriting of existing files.  When DSZ is restricted, it
  628.           will refuse to transfer files containing the string autoexec.bat and
  629.           command.com in upper or lower case.  This provides some defense from
  630.           malicious uploaded files.
  631.  
  632.     t     [-8g] Talk with ZMODEM AutoDownload.  The optional -8g (available on
  633.           registered copies only) allows "BBS (ANSI) graphics".  A small
  634.           subset of ZCOMM/Pro-YAM term function subcommands are recognized.
  635.           Keyboard F1 or ALT-X to exit.  F3 receives file(s) with True
  636.           YMODEM(TM), ALT-P toggles parity between the 8n default and 8g
  637.           (enables ANSI "graphics").  ALT-H toggles two local echo ("Half
  638.           Duplex") modes; the second displays a newline (CR/LF) when Enter is
  639.           keyboarded.  Keyboarded ASCII characters are sent to the modem.
  640.           Modem characters print on the screen.  A device driver such as
  641.           ANSI.SYS may be used to recognize escape sequences.  ZMODEM
  642.           AutoDownload detects the start of a ZMODEM file download and accepts
  643.           the file(s) without operator intervention.
  644.  
  645.     rz    [-abenprt+Yy] [dir] [file ...]          (ZMODEM receive)
  646.  
  647.     rb    [-abt+y] [dir] [file ...]     (YMODEM receive)
  648.  
  649.     rb -g [-abt+y] [dir] [file ...]     (YMODEM-g receive)
  650.  
  651.     rc    [-abt+y] file1                (XMODEM/CRC receive)
  652.  
  653.  
  654.  
  655.  
  656.     Chapter 3              Rev 6-30-88  Typeset 7-11-88                     10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.     Chapter 3                  DSZ Quick Reference                          11
  665.  
  666.  
  667.  
  668.     ro    [-abt+y] file1                (XMODEM OverThruster receive)
  669.  
  670.     rx    [-abt+y] file1                (XMODEM receive)
  671.  
  672.     rx    -g [-abt+y] file1             (Qmodem-G receive)
  673.  
  674.  
  675.     sz    [-abefnprtY+y] [-w[N]]  file ...        (ZMODEM send)
  676.  
  677.     sb    [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM, YMODEM-g send)
  678.  
  679.     sb -k [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM-1k send)
  680.  
  681.     sx    [-t] file1                    (XMODEM, XMODEM/CRC, Qmodem-G send)
  682.  
  683.     sx -k [-t] file1                    (XMODEM-1k send)
  684.     The meanings of the optional arguments are described in the ZCOMM manual.
  685.  
  686.     Send files may be specified indirectly:
  687.                                dsz sz @C:files.lst
  688.     sends the files in C:files.lst.  This provides another means of bypassing
  689.     the DOS command line limit.  The first letter must be "@" and the third
  690.     letter must be ":" to distinguish this from an ordinary pathname.
  691.     Pathnames in the indirect may be separated with any combination of
  692.     space(s), tab(s), CR and/or LF.  No spaces may appear inside a pathname;
  693.     "FOO     .BAR" won't work.
  694.  
  695.     3.1  Interrupt Keys
  696.  
  697.     Ctrl-Break Terminates the transfer in progress.
  698.  
  699.     ALT-N Abruptly terminates (NUKES) the transfer in progress.
  700.  
  701.     Ctrl-X Typing a dozen Ctrl-X characters to another ZMODEM program
  702.          terminates ZMODEM operations.
  703.  
  704.     ALT-F Skips the current file in ZMODEM transfers.
  705.  
  706.     ALT-B Cancels the current ZMODEM session.
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.     Chapter 3              Rev 6-30-88  Typeset 7-11-88                     11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.     Chapter 4                  DSZ Quick Reference                          12
  731.  
  732.  
  733.  
  734.     4.  NUMERIC PARAMETERS
  735.  
  736.     DSZ uses the following main numeric parameters, settable with the pxN
  737.     command.
  738.  
  739.     EXAMPLE: C>dsz pQ0
  740.  
  741.  
  742.     In addition, DSZ uses the Pro-YAM/ZCOMM zmodem numeric parameters
  743.     described in the Pro-YAM/ZCOMM reference manual.
  744.  
  745.  
  746.     B   Set the size of buffer used for disk reads and writes.  The default is
  747.         1024, 8192 maximum.  If your copy of DSZ is running on a floppy disk
  748.         system or a very slow turkey hard disk, a larger value may give better
  749.         results.  Too large a value may exhaust memory, induce receiver
  750.         timeouts, cause disconnects(!), or generate spurious CRC errors.  If
  751.         performance logging doesn't work, this parameter is too big.  This
  752.         parameter is supported on versions compiled with TurboC.
  753.  
  754.         EXAMPLE: C>dsz pB4096 sz A:floppy.fil
  755.  
  756.         Setting the buffer size larger may lock out the performance log,
  757.         DSZFILES, and/or indirect pathname list in the "tiny model" DSZ
  758.         flavor.  If you aren't bloody sure you need a bigger buffer, don't use
  759.         one.
  760.  
  761.     O   This parameter controls XMODEM OverThruster(TM).  It is described in
  762.         dszbg.doc.  This file is part of the software package sent to paid
  763.         registrants.
  764.  
  765.     Q   Error code returned to DOS (default 1).  (Success returns 0.) Some
  766.         programs toss cookies when confronted with certain exit codes.
  767.  
  768.         EXAMPLE: C>dsz pQ-1 sz foo.bar
  769.  
  770.  
  771.     S   Timeout in seconds (default 15) waiting for restraint release (XON
  772.         and/or handshake).
  773.  
  774.     W   Wait for Enter key before exiting after an error.  Effective on
  775.         registered copies.  Useful when calling DSZ from DESQview, allows the
  776.         window to close unless there is an error message that should remain
  777.         visible.
  778.  
  779.     a   Calibrates certain protocol timeouts used with XMODEM and YMODEM
  780.         transfers (Cybernetic Data Recovery(TM)).  This parameter does not
  781.         affect ZMODEM transfers.
  782.  
  783.         The a numeric parameter is automatically set to 2000 for a 4.77 mHz PC
  784.         or XT, 4000 for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for a
  785.  
  786.  
  787.  
  788.     Chapter 4              Rev 6-30-88  Typeset 7-11-88                     12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.     Chapter 4                  DSZ Quick Reference                          13
  797.  
  798.  
  799.  
  800.         PS2/80.  If your computer has a speedup card or otherwise runs
  801.         unusually fast (or slow!) for its type, you may set the a numeric
  802.         parameter to a value that reflects its speed.
  803.  
  804.         EXAMPLE: dsz port 2 pa4000 rb
  805.  
  806.  
  807.         NOTE: Setting this parameter does not suppress the "Unknown Machine
  808.         Type" message which is displayed before the command line is scanned.
  809.  
  810.     d   A non zero value (the default) causes incoming files received with
  811.         ZMODEM and full YMODEM transfers to have their Date set to that sent
  812.         in the file header.  ZMODEM's file management features depend on the
  813.         transmission of each file's modification date.  Files will have the
  814.         same creation date, even if the two machines are in different time
  815.         zones.  When transferring files to/from a Unix system, creation dates
  816.         are interpreted according to GMT or Universal Coordinated Time.  File
  817.         dating may be disabled with a pd0 command.
  818.         NOTE: Backdating file creation times may confuse some backup programs.
  819.  
  820.     v   Verbose level (debugging output) Negative values inhibit some routine
  821.         messages.  Setting v to 1 or greater causes serialized copies to ring
  822.         the bell when a transfer is done.
  823.  
  824.     z   Timezone in minutes behind GMT, used for ZMODEM and True YMODEM file
  825.         transfers to coordinate the actual date of the file with computers in
  826.         other time zones.  Effective on registered copies.  PDT or MST
  827.         corresponds to 420.  This may be preset with the ZONE DOS environment
  828.         variable.
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.     Chapter 4              Rev 6-30-88  Typeset 7-11-88                     13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.     Chapter 5                  DSZ Quick Reference                          14
  863.  
  864.  
  865.  
  866.     5.  ENVIRONMENT VARIABLES
  867.  
  868.     The following DOS environment variables may be set to modify DSZ
  869.     operation.
  870.  
  871.     DIRRX (Registered copies only.) Specifies the directory to receive
  872.         (download) files.  If the sting in DIRRX ends with "/", directory
  873.         and/or disk designators in the incoming pathname are stripped, and
  874.         only the stem (name and extension) is used.  Otherwise, if an incoming
  875.         file has an absolute pathname, the incoming pathname is used.
  876.  
  877.         EXAMPLE: C>set DIRRX=C:/rxdirect/
  878.         C>dsz rz -r
  879.  
  880.  
  881.     DSZFILES May contain a list of up to 9999 pathnames to transmit, with
  882.         entries separated by spaces.  If present, DSZFILES is used in place of
  883.         a normal command line list of files to send with the sb and sz
  884.         commands.
  885.  
  886.         EXAMPLE: C>set DSZFILES=file1 file2 file3 *.c
  887.         C>dsz port 2 handshake on sz -r
  888.  
  889.         In practice, this string would be built up by a calling program and
  890.         passed to DSZ with a "spawnvpe", "execvpe", or similar subroutine
  891.         call.
  892.  
  893.         SEE ALSO: Pathname list specification @C:files.lst
  894.  
  895.     DSZLOG log file to receive entries for files sent and received.  (Default
  896.         null).  Sample entries:
  897.  
  898.     Z  46532 38400 bps 3324 cps   0 errors    66 1024 DSZ.COM 1177
  899.     Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP 1177
  900.  
  901.         Transfer times are based on the DOS time of day clock and have one
  902.         second jitter.  As with all protocol throughput reports generated by
  903.         Omen Technology programs (and contrary to the false claims of some
  904.         critics), DSZ's throughput figures for ZMODEM, Kermit, and True
  905.         YMODEM(TM) transfers do not take "credit" for pathname and/or protocol
  906.         overhead characters.  DSZ's throughput reports do not include the time
  907.         required to send the pathname.  This understates the true time
  908.         required to transfer files, but the time required to send the pathname
  909.         often depends on the alacrity of the operator, and thus does not
  910.         always reflect the performance of the protocol itself.
  911.  
  912.         Transfers measuring less than one second are reported as having 9999
  913.         characters per second throughput.
  914.  
  915.         The unlabeled numeric field after the error (retry) count is the
  916.         number of flow control stoppages encountered sending the file.  This
  917.  
  918.  
  919.  
  920.     Chapter 5              Rev 6-30-88  Typeset 7-11-88                     14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.     Chapter 5                  DSZ Quick Reference                          15
  929.  
  930.  
  931.  
  932.         number gives an indication of flow control restrictions (overloaded
  933.         networks, etc.) encountered during the transfer.
  934.  
  935.         The last numeric field before the file name is the block or subpacket
  936.         length used for the last block in the file.
  937.  
  938.         The last field is the serial number of the other program, or -1 if
  939.         this information is not available.
  940.  
  941.         The code letter indicates the type of transfer, Z (ZMODEM), S
  942.         (X/YMODEM), R (X/YMODEM), E (error), or L (transfer terminated by loss
  943.         of data carrier).
  944.  
  945.         WARNING: If DSZ encounters a loss of carrier or other fatal error
  946.         condition before a file commences transmission, a log entry will not
  947.         be made.
  948.  
  949.         EXAMPLE: C>set DSZLOG=C:/yam/dszlog
  950.  
  951.  
  952.     DSZOPT (Registered copies only) String containing default options for DSZ
  953.         file transfers.  Options are optional modifiers to the DSZ sz, rz, sx,
  954.         rx, sb, rb commands.
  955.  
  956.         An 8n may be appended to the string to make BBS (ANSI) graphics the
  957.         default for DSZ's t command.  The ability to preset these options is
  958.         especially helpful for controlling ZMODEM automatic downloads from
  959.         DSZ's t command.
  960.  
  961.         EXAMPLE: C>set DSZOPT=r
  962.         Enables DSZ's intelligent Crash Recovery as a default.
  963.  
  964.         Let's say you wish ZMODEM crash recovery, and BBS "graphics" for the
  965.         DSZ term function:
  966.         C>set DSZOPT=r8g
  967.  
  968.  
  969.         WARNING: Do NOT include "ena" or any other commands in the DSZOPT
  970.         string.  With the exception of the "8g" mode, only **options** may be
  971.         placed in the DSZOPT string!  (Options are the letters that modify the
  972.         sz, rz, sb, etc. commands.  In "rz -r", "r" is an option.)
  973.  
  974.     MAXBYTES Maximum number of bytes allowed for transfer.  If this number is
  975.         exceeded, DSZ skips the offending files (ZMODEM) or aborts remaining
  976.         files in the batch (YMODEM).
  977.  
  978.     DSZPORT Default communications port override, default 1.
  979.         EXAMPLE:
  980.         C>set DSZPORT=2
  981.  
  982.  
  983.  
  984.  
  985.  
  986.     Chapter 5              Rev 6-30-88  Typeset 7-11-88                     15
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.     Chapter 5                  DSZ Quick Reference                          16
  995.  
  996.  
  997.  
  998.     ZONE sets the z numeric parameter to the number of minutes the current
  999.         local time lags GMT time.  PDT or MST corresponds to 420.  (Registered
  1000.         copies only)
  1001.         EXAMPLE:
  1002.         C>set ZONE=420
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.     Chapter 5              Rev 6-30-88  Typeset 7-11-88                     16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.     Chapter 6                  DSZ Quick Reference                          17
  1061.  
  1062.  
  1063.  
  1064.     6.  EXAMPLES
  1065.  
  1066.     dsz sz c:foo.* b:*.c          (send files)
  1067.  
  1068.     dsz sz -r yzmodem.arc         (CRASH RECOVERY: resume interrupted
  1069.     transfer)
  1070.  
  1071.     dsz rz -r                     (CRASH RECOVERY: resume interrupted
  1072.     transfer)
  1073.  
  1074.     dsz handshake both sz yzmodem.arc       (Hardware+Software handshake)
  1075.  
  1076.     dsz sz -n *.*                 (send files that are newer or rx has no
  1077.     copy)
  1078.  
  1079.     dsz sz -Yn *.*                (Only send files that are newer than
  1080.     receiver's copy)
  1081.                                   (Do not send files that do not exist on
  1082.     receiver's disk)
  1083.  
  1084.     dsz rz C:/UPLOADS             (receive files to specified directory)
  1085.  
  1086.     dsz port 2 speed 38400 restrict rz
  1087.  
  1088.     dsz rz  -y prog.arc           (ZMODEM, single file pathname override)
  1089.  
  1090.     dsz z pr1 rx foo.dat          (XMODEM receive, remove file if error)
  1091.  
  1092.     dsz pO60 ro foo.dat           (XMODEM/OverThruster receive, GEnie MNP)
  1093.  
  1094.     DSZ LRC L-Y NEWPROG.ARC       (generate lower case "rc -y" command)
  1095.  
  1096.     dsz pv2 sz foo >debug.dmp     (Debugging data dump)
  1097.  
  1098.     dsz sz @C:/bbs/files.lst      (Indirect file list)
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.     Chapter 6              Rev 6-30-88  Typeset 7-11-88                     17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.     Chapter 7                  DSZ Quick Reference                          18
  1127.  
  1128.  
  1129.  
  1130.     7.  BACKGROUND OPERATION
  1131.  
  1132.     Three DESQview description files are provided to demonstrate background
  1133.     operation with modest (66 kb window) memory requirements.  DSZ uses tight
  1134.     C/ASM code, table driven CRC generators, and buffered receive and transmit
  1135.     for good performance in the background without hogging CPU cycles.  On a
  1136.     QIC Labs PC-AT clone, DSZ can download files in the background (3
  1137.     background clock ticks, 9 foreground clock ticks) with a throughput better
  1138.     than 9600 bps.
  1139.  
  1140.     2S   Prompts for file name(s) and sends them with ZMODEM protocol.  File:
  1141.          2S-PIF.DVP
  1142.  
  1143.     2T   Talks to the modem and allows manual YMODEM (F3) or automatic ZMODEM
  1144.          downloads.  File: 2T-PIF.DVP
  1145.  
  1146.     2A   Like 2T, but using Quarterdeck's dvansi.com memory resident ANSI CRT
  1147.          device driver to process ANSI screen codes.  File: 2A-PIF.DVP DS.BAT
  1148.          is the batch file used by 2A.
  1149.  
  1150.     These files are written for a port 2 local connection and \TMP directory,
  1151.     but may be modified to suit your requirements using the DESQview CP
  1152.     command.  The W numeric allows DESQview to close the window after DSZ
  1153.     finishes, providing a pleasant user interface.
  1154.  
  1155.     Operation at high speed (above 9600 bps) requires the DESQview "Optimize
  1156.     communications" performance Advanced Setup option.
  1157.  
  1158.            ***********************************************************
  1159.                                      WARNING
  1160.     When running DSZ under a multi tasking system such as DESQview, do not
  1161.     allow two programs to access the same comm port at the same time.  At
  1162.     best, such actions will disrupt communications.  At worst, your computer
  1163.     will attempt to open a subspace channel to V'ger.
  1164.            ***********************************************************
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.     Chapter 7              Rev 6-30-88  Typeset 7-11-88                     18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.     Chapter 8                  DSZ Quick Reference                          19
  1193.  
  1194.  
  1195.  
  1196.     8.  CALLING DSZ FROM COMM PROGRAMS
  1197.  
  1198.     8.1  GT POWER 13.00/14.00
  1199.  
  1200.     GT Power version 13/14 includes a YMRX.BAT (YMODEM-g receive) file with an
  1201.     "rz" command.  You guessed it, "rz" is for ZMODEM protocol (the z means
  1202.     ZMODEM!).  Please change the file to use the correct "rb -g" for YMODEM-g.
  1203.  
  1204.     The files ZMTX.ARC and GT1300.NOT available on many bulletin boards
  1205.     contain useful information for GT Power users.
  1206.  
  1207.     8.2  PROCOMM
  1208.  
  1209.     DSZ may not operate properly when called from Procomm if Procomm has files
  1210.     open at the time.
  1211.  
  1212.     When running under ProComm's Host mode, failure to use the CON command may
  1213.     cause Procomm to lock up the computer.
  1214.  
  1215.     The POE, PCALL, DSZ_ZAP, and PROZ programs have been popular in
  1216.     interfacing DSZ to Procomm's editor gateway.
  1217.  
  1218.     Hint: the DOS PATH environment variable must include Procomm's directory
  1219.     to allow POE to locate all the POE files,.  The POE files should be stored
  1220.     in the Procomm directory.  Setting the "PROCOMM" environment variable is
  1221.     insufficient.
  1222.  
  1223.     8.3  PROCOMM PLUS
  1224.  
  1225.     DSZ may not operate properly when called from Procomm if Procomm has files
  1226.     open at the time.
  1227.  
  1228.     Here are some handy settings for Procomm Plus.
  1229.  
  1230.     First, set the DOS environment as necessary before running Procomm:
  1231.     SET DSZPORT=2                           (Only needed for COM2)
  1232.     SET DSZLOG=DSZ.LOG            (If you wish a log file)
  1233.  
  1234.     Then set Procomm's external protocol strings:
  1235.     A- External protocol 1 upload filename  ...ZMODEMU
  1236.     B- External protocol 1 download filename ... ZMODEMD
  1237.  
  1238.     And then some short batch files:
  1239.     ZMODEMU.BAT:                  DSZ sz %1 %2 %3 %4 %5 %6 %7 %8 %9
  1240.     ZMODEMD.BAT:    DSZ rz
  1241.  
  1242.     To make downloads easier, use the "dsz t" command described above.
  1243.     ZMODEMT.BAT:                  DSZ t
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.     Chapter 8              Rev 6-30-88  Typeset 7-11-88                     19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.     Chapter 8                  DSZ Quick Reference                          20
  1259.  
  1260.  
  1261.  
  1262.     8.4  BULLETIN BOARDS
  1263.  
  1264.     When installing DSZ on a bulletin board or host system, be sure to check
  1265.     for proper operation when the caller hangs up while a file is being sent
  1266.     or received.
  1267.  
  1268.     Currently, Only the TurboC version supports file sharing (shared read
  1269.     access on files sent by  dsz).
  1270.  
  1271.     Some bulletin board interface routines do not call DSZ to send a file
  1272.     until they have verified the file's presence by opening the file.  If this
  1273.     checking is done in DOS's default exclusive open mode, dsz's file sharing
  1274.     will be defeated.
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.     Chapter 8              Rev 6-30-88  Typeset 7-11-88                     20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.     Chapter 9                  DSZ Quick Reference                          21
  1325.  
  1326.  
  1327.  
  1328.     9.  FLOW CONTROL
  1329.  
  1330.     If you plan to send files over Telenet (PC-Pursuit), you must refer to the
  1331.     Pro-YAM or ZCOMM Reference manual (in ZCOMMDOC.ARC) FLOW CONTROL chapter
  1332.     for vital information on flow control considerations necessary for proper
  1333.     operation of ZMODEM and other streaming protocols.
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.     Chapter 9              Rev 6-30-88  Typeset 7-11-88                     21
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.     Chapter 10                 DSZ Quick Reference                          22
  1391.  
  1392.  
  1393.  
  1394.     10.  ERROR MESSAGES
  1395.  
  1396.     COM2 1200 bps Carrier Detect enabled Handshake slow
  1397.     Command line = (commands)
  1398.     This is a normal message displayed to help resolve problems with incorrect
  1399.     batch files.  The port number, speed, carrier detect ("enabled" or
  1400.     "DISABLED") and "handshake" indicate the selected mode of operation.
  1401.  
  1402.     Unknown Machine Type XX, 'a' parameter preset to 6000 indicates a ROM BIOS
  1403.     that does not follow the IBM specification for identifying the machine
  1404.     type.  If your computer causes DSZ to display this message, you may set
  1405.     the a numeric parameter described elsewhere in this document.  This
  1406.     message is generated before any commands are read, so do not be alarmed
  1407.     when setting the a parameter doesn't make this message go away.  The a
  1408.     parameter does not affect ZMODEM transfers.
  1409.  
  1410.     Need more memory to run DSZ or Abnormal program termination is displayed
  1411.     by the TurboC startup routine if DSZ is run in too small a memory
  1412.     partition.  If you see this message, use a larger memory partition for DSZ
  1413.     or remove some memory resident programs.  This message may also appear if
  1414.     the calling program fails to free memory before calling DSZ.
  1415.  
  1416.     CARRIER LOST is displayed when DSZ recognizes a loss or lack or carrier
  1417.     detect signal from the modem.  This is caused by a line disconnect,
  1418.     defective cable, or incorrect modem strapping.  It may be disabled with
  1419.     the d command.  Sometimes this is caused by setting the B parameter to too
  1420.     large a value.
  1421.  
  1422.     Garbage Count Exceeded Indicates ZMODEM has not detected a valid start of
  1423.     header in a reasonable number of characters.
  1424.  
  1425.     If DSZ becomes "stuck" on emitting this messages, it is possible the
  1426.     sending program may not be able to recognize and act upon transmission
  1427.     requests (ZROPS headers).  The sending program should be corrected.  In
  1428.     the meantime, setting a ZMODEM packet length with the "zmodem pl4096"
  1429.     command forces the sender to wait for the receivers' progress reports.
  1430.  
  1431.     Permission denied comes from the Microsoft C Library.  This may be caused
  1432.     by attempts to modify a read only file or directory, or create a file in a
  1433.     nonexistient directory.
  1434.  
  1435.     A furtive flashing appearance of XOFF or FLOW during ZMODEM or YMODEM-g
  1436.     file sending signifies DSZ is responding to flow control restraint.  This
  1437.     is normal operation when buffered modems or packet switched networks are
  1438.     used.  ZMODEM's robustness and reliability allow creative users to
  1439.     transfer files over unusual multiple computer lash-ups, causing modem data
  1440.     lights and computer status displays to dance in unfamiliar rhythms.  Got
  1441.     ZRPOS indicates the receiving program has detected a transmission error
  1442.     and has requested retransmission.  In other words, ZMODEM is doing its job
  1443.     of detecting and correcting missing and garbled data.  If this happens
  1444.     more often than observed line errors would indicate is reasonable, there
  1445.  
  1446.  
  1447.  
  1448.     Chapter 10             Rev 6-30-88  Typeset 7-11-88                     22
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.     Chapter 10                 DSZ Quick Reference                          23
  1457.  
  1458.  
  1459.  
  1460.     may be a flow control problem in one of four areas:
  1461.  
  1462.       + Between the sending program and its modem.  If using an interface
  1463.         speed higher than the transmission speed, or modem to modem error
  1464.         correction (MNP, LAPB, PEP, etc.), check that the modem and the
  1465.         sending program are configured for the same flow control methods.  DSZ
  1466.         is faster than most other programs, and may expose flow control
  1467.         problems not seen with slower software.
  1468.  
  1469.       + Between the sending modem and the network.  Correcting this requires
  1470.         "handshake both" to allow the sending program to honor both hardware
  1471.         (CTS) flow control from the modem and software flow control (XON/XOFF)
  1472.         from the network.
  1473.  
  1474.       + Between parts of the network.
  1475.  
  1476.       + Between the receiving modem and the receiving program.  This can
  1477.         happen at high transmission speeds when the receiver has specified a
  1478.         large I/O buffer size with the B numeric parameter.
  1479.  
  1480.         Excessive interrupt latency from extended memory ramdisks or disk
  1481.         caches, and poorly written hard disk drivers also wreak havoc on
  1482.         streaming protocols but do not affect start-stop protocols (XMODEM,
  1483.         etc.).
  1484.  
  1485.         To correct these problems, give the "handshake slow" command to the
  1486.         receiver.
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.     Chapter 10             Rev 6-30-88  Typeset 7-11-88                     23
  1515.  
  1516.  
  1517.  
  1518.  
  1519.